###Function###
FileReadLine

###Description###
Liest eine Textzeile aus einer zuvor geffneten Textdatei.

###Syntax###
FileReadLine ( "filehandle/filename" [, line = 1] )


###Parameters###
@@ParamTable@@
filehandle/filename
	Das Handle der Datei, wie es von einem frheren Aufruf von <a href="FileOpen.htm">FileOpen()</a> zurckgegeben wurde. Alternativ kann ein String mit dem Dateinamen als erster Parameter verwendet werden.
line
	[optional] Die Zeilennummer, die gelesen werden soll. Die erste Zeile einer Textdatei hat die Nummer 1 (nicht 0). Die letzte Zeile ist -1.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Eine Textzeile.
Fehler:	Setzt @error ungleich null
@error:	1 = die Datei wurde nicht im Lesemodus (read mode) geffnet oder ein anderer Fehler ist aufgetreten.
	-1 = das Dateiende wurde erreicht.
@@End@@


###Remarks###
Gibt eine Textzeile zurck. Die am Zeilenende eingelesenen Zeilenumbrche (<a href="Chr.htm">Chr</a>(10) oder @LF) werden automatisch entfernt.
Wenn keine Zeilennummer zum Lesen angegeben wurde, wird die "nchste" Zeile eingelesen (die "nchste" bedeutet bei einer neu geffneten Datei die erste Zeile).
Wenn ein Dateiname statt eines Dateihandles angegeben wird, wird die Datei whrend des Funktionsaufrufes geffnet und geschlossen. Fr die Bearbeitung groer Textdateien ist das viel langsamer als die Arbeit mit Handles.
Hinweis: Die Verwendung von Dateihandles und -namen sollte nicht vermischt werden. So sollte man  z.B. vermeiden, eine Datei mit <a href="FileOpen.htm">FileOpen()</a> zu ffnen und dann in dieser Funktion einen Dateinamen verwenden. Es sind entweder Handles oder Dateinamen zu benutzen - nicht beides.

In Hinblick auf Geschwindigkeit ist es keine gute Idee, eine Datei zeilenweise einzulesen, indem der line-Parameter jeweils um 1 erhht wird. Dadurch ist AutoIt gezwungen, die Datei jedesmal neu vom Beginn bis zur angegebenen Zeile einzulesen.

Sowohl ANSI als auch UTF16/UTF8 formatierte Texte knnen gelesen werden - AutoIt erkennt den Typ automatisch.


###Related###
IniRead, FileOpen, FileRead, FileWrite, FileWriteLine, FileSetPos, FileGetPos


###Example###
@@IncludeExample@@
